home *** CD-ROM | disk | FTP | other *** search
XXXXSSSSGGGGIIII((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666)))) XXXXSSSSGGGGIIII((((1111)))) NNNNAAAAMMMMEEEE Xsgi - X Window System server for Silicon Graphics workstations. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS XXXXssssggggiiii [:displaynumber] [-option ...] DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN _X_s_g_i is the name for the Silicon Graphics, Inc. X Window System server. The server supports the X version 11 protocol, and is based on Release 6 of the X Consortium distribution. The X Window System is described in _X _W_i_n_d_o_w _S_y_s_t_e_m by Scheifler and Gettys (Digital Press, ISBN 1- 55558-088-2). For details on use of the X Window System, it is recommended that you refer to the _X _W_i_n_d_o_w _S_y_s_t_e_m _U_s_e_r'_s _G_u_i_d_e _f_o_r _V_e_r_s_i_o_n _1_1 (_V_o_l_u_m_e _I_I_I), by Tim O'Reilly, Valerie Quercia, and Linda Lamb (O'Reilly & Associates, ISBN 0-937175-29-3). In addition, you may find the following books to be useful: _X_l_i_b _P_r_o_g_r_a_m_m_i_n_g _M_a_n_u_a_l (_V_o_l_u_m_e _I), by Adrian Nye, O'Reilly & Associates, ISBN 0-937175-26-9 _X_l_i_b _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l (_V_o_l_u_m_e _I_I), O'Reilly & Associates, ISBN 0-937175-27-7 SSSSTTTTAAAARRRRTTTTIIIINNNNGGGG TTTTHHHHEEEE SSSSEEEERRRRVVVVEEEERRRR _X_s_g_i is normally run by the _x_d_m program from _i_n_i_t. However, it may also be started by hand, using the interface described here, or by running _x_d_m by hand. Details on _x_d_m may be found in the _x_d_m(_1) man page. HHHHAAAARRRRDDDDWWWWAAAARRRREEEE SSSSUUUUPPPPPPPPOOOORRRRTTTT In IRIX 4.0 and 5.0, _X_s_g_i exports visuals supporting most available hardware. All servers support 8-bit PseudoColor. 24-bit TrueColor is available on equipped machines. Depending on hardware, 2- or 4-bit PseudoColor may be available, possibly for use of overlay planes. Other visuals may be available. For details on the nature of visuals, see _X_l_i_b _P_r_o_g_r_a_m_m_i_n_g _M_a_n_u_a_l, described above. Available visuals may be interrogated with _x_d_p_y_i_n_f_o(_1) or, from within a program, via _X_M_a_t_c_h_V_i_s_u_a_l_I_n_f_o(_3_X), or _X_G_e_t_V_i_s_u_a_l_I_n_f_o(_3_X). PPPPRRRROOOOTTTTOOOOCCCCOOOOLLLL EEEEXXXXTTTTEEEENNNNSSSSIIIIOOOONNNNSSSS Extensions to the core X protocol may be available on a given instance of _X_s_g_i. Among the several extensions supported at time of writing are _A_d_o_b_e _P_o_s_t_S_c_r_i_p_t_T_M, _X _I_n_p_u_t _E_x_t_e_n_s_i_o_n (tablet, spaceball, dials, etc), _S_H_A_P_E (non rectanglular windows) and _X_i_n_e_r_a_m_a. Available extensions may be interrogated with _x_d_p_y_i_n_f_o(_1), or, from within a program, via _X_Q_u_e_r_y_E_x_t_e_n_s_i_o_n(_3_X), or _X_L_i_s_t_E_x_t_e_n_s_i_o_n_s(_3_X). OOOOPPPPTTTTIIIIOOOONNNNSSSS PPPPaaaaggggeeee 1111 ((((pppprrrriiiinnnntttteeeedddd 11110000////3333////00002222)))) XXXXSSSSGGGGIIII((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666)))) XXXXSSSSGGGGIIII((((1111)))) _X_s_g_i accepts the following command line options: ----aaaa _p_i_x_e_l_s sets the mouse acceleration threshold ----aaaarrrrtttt _t_i_m_e_o_u_t sets the keyboard autorepeat timeout ----aaaarrrriiii _i_n_t_e_r_v_a_l sets the keyboard autorepeat interval ----aaaauuuutttthhhh _f_i_l_e_n_a_m_e selects authorization file bbbbcccc enables bug compatibility mode. There was a bug in pre-R4 servers which allowed a common protocol violation. This option asks the server to disable detection of that particular protocol violation. It is supplied solely to allow old programs with the bug to work. ----bbbbooooaaaarrrrddddssss _b_o_a_r_d_n_u_m_b_e_r-_r_a_n_g_e specifies the graphics boards that the X server should use. _b_o_a_r_d_n_u_m_b_e_r-_r_a_n_g_e is either a single number or a comma separated list of numbers specifying the desired graphics boards. The graphics board numbers can be determined by examining the report from _g_f_x_i_n_f_o(_1_G). For example, to tell the X server to use graphics board 2 use -_b_o_a_r_d_s _2. To tell the X server to use graphics boards 0 and 1 use -_b_o_a_r_d_s _0,_1. The default behavior is for the X server to use all available graphics boards. ----bbbbooooaaaarrrrddddbbbbaaaasssseeee _h_e_x_I_n_t sets base address of board communication space ----bbbbooooaaaarrrrddddssssiiiizzzzeeee _h_e_x_I_n_t sets amount of space to reserve per board in bytes ----bbbbssss disables backing store support on all screens ----cccc turns off key-click cccc _p_e_r_c_e_n_t sets key-click volume (0-100). Note: currently, the volume has two states: on and off. ----ccccllllaaaassssssss _c_l_a_s_s_N_a_m_e sets class of default visual ----ccccoooo _f_i_l_e_n_a_m_e Page 2 (printed 10/3/02) XXXXSSSSGGGGIIII((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666)))) XXXXSSSSGGGGIIII((((1111)))) sets name of RGB color database. The default is /_u_s_r/_l_i_b/_X_1_1/_r_g_b ----ccccuuuurrrrssssoooorrrrFFFFGGGG _c_o_l_o_r-_n_a_m_e specifies the initial foreground color for the cursor. ----ccccuuuurrrrssssoooorrrrBBBBGGGG _c_o_l_o_r-_n_a_m_e specifies the initial background color for the cursor. ----ddddddddxxxxddddiiiirrrr _p_a_t_h specifies directory to use for dynamic DDX modules (which are dynamic shared objects for IRIX 5.x and 6.x). The default is /_u_s_r/_l_i_b/_X_1_1/_d_y_D_D_X. ----ddddeeeepppptttthhhh _i_n_t sets depth of default visual ----ddddeeeevvvvddddiiiirrrr _p_a_t_h specifies directory to use for input devices. The default is /_d_e_v/_i_n_p_u_t. ----ddddppppiiii _i_n_t sets screen resolution pixels per inch ----ffff _p_e_r_c_e_n_t sets the bell base volume ----ffffcccc _c_u_r_s_o_r_F_o_n_t sets default cursor font. This defaults to _c_u_r_s_o_r. ----ffffiiiirrrrsssstttt prevents the server from opening any but the first available screen. ----ffffnnnn _f_o_n_t sets the server default font. This defaults to _f_i_x_e_d. ----ffffpppp _f_o_n_t_P_a_t_h sets the search path for fonts. This defaults to /_u_s_r/_l_i_b/_X_1_1/_f_o_n_t_s/_1_0_0_d_p_i/, /_u_s_r/_l_i_b/_X_1_1/_f_o_n_t_s/_7_5_d_p_i/, /_u_s_r/_l_i_b/_X_1_1/_f_o_n_t_s/_m_i_s_c/, /_u_s_r/_l_i_b/_X_1_1/_f_o_n_t_s/_T_y_p_e_1/, /_u_s_r/_l_i_b/_X_1_1/_f_o_n_t/_S_p_e_e_d_o/, /_u_s_r/_l_i_b/_X_1_1/_f_o_n_t/_C_I_D/ ----hhhheeeellllpppp prints a usage message ----hhhhwwww _d_e_v_i_c_e specifies options on a per-screen basis. In addition to a bbbbooooaaaarrrrdddd argument, allowed options include ccccllllaaaassssssss, ddddeeeepppptttthhhh, oooovvvveeeerrrrllllaaaayyyy, ppppsssseeeeuuuuddddoooommmmaaaapppp, ssssttttaaaattttiiiiccccmmmmaaaapppp, and vvvviiiissssiiiidddd. As Page 3 (printed 10/3/02) XXXXSSSSGGGGIIII((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666)))) XXXXSSSSGGGGIIII((((1111)))) an example, to set up screen 0 of a two-headed system to be 8-bit PseudoColor, and screen 1 to be 24-bit TrueColor, you would use ----hhhhwwww bbbbooooaaaarrrrdddd====0000,,,,ccccllllaaaassssssss====PPPPsssseeeeuuuuddddooooCCCCoooolllloooorrrr,,,,ddddeeeepppptttthhhh====8888 ----hhhhwwww bbbbooooaaaarrrrdddd====1111,,,,ccccllllaaaassssssss====TTTTrrrruuuueeeeCCCCoooolllloooorrrr,,,,ddddeeeepppptttthhhh====22224444 On a multi-headed system, lllleeeefffftttt, rrrriiiigggghhhhtttt, aaaabbbboooovvvveeee, and bbbbeeeelllloooowwww allow you to specify the logical relationship of each screen with respect to one another. For example, to specify that display 0 is logically above display 1, you would use ----hhhhwwww bbbbooooaaaarrrrdddd====0000,,,,bbbbeeeelllloooowwww====1111 ----hhhhwwww bbbbooooaaaarrrrdddd====1111,,,,aaaabbbboooovvvveeee====0000 If XXXXiiiinnnneeeerrrraaaammmmaaaa extension is enabled for a multi-headed system, xxxxooooffffffffsssseeeetttt and yyyyooooffffffffsssseeeetttt allow you to indicate relative offsets of one screen with respect to its neighbours. The value should be negative to indicate an overlap. In the previous example, to indicate that display 1 has an overlap of 60 pixels with display 0, you would use ----hhhhwwww bbbbooooaaaarrrrdddd====0000,,,,bbbbeeeelllloooowwww====1111 ----hhhhwwww bbbbooooaaaarrrrdddd====1111,,,,aaaabbbboooovvvveeee====0000,,,,yyyyooooffffffffsssseeeetttt====----66660000 ----IIII causes _X_s_g_i to ignore all remaining arguments ----iiiinnnnppppuuuuttttddddiiiirrrr _p_a_t_h specifies directory to use for input configuration files. The default is /_u_s_r/_l_i_b/_X_1_1/_i_n_p_u_t. ----ccccoooonnnnffffiiiiggggddddiiiirrrr _p_a_t_h specifies directory to use for device-specific configuration files. The default is /_u_s_r/_l_i_b/_X_1_1/_i_n_p_u_t/_c_o_n_f_i_g. ----kkkkbbbbddddddddeeeevvvv _d_e_v_i_c_e sets the name of core keyboard device to use. ----kkkkeeeeyyyymmmmaaaapppp _d_e_v_i_c_e sets the name of keymap to use. Omitting this option causes the server to use its only builtin keymap, which supports the USA keyboard. Keymap files are named _n_a_m_e.xkm. See -_i_n_p_u_t_d_i_r, above. ----llllooooggggoooo turns on the X Window System logo display in the screen-saver nnnnoooollllooooggggoooo turns off the X Window System logo display in the screen-saver ----nnnnoooobbbbiiiittttssssccccaaaalllleeee do not support scaling of bitmap fonts. By default _X_s_g_i supports scaling of bitmap fonts to any size. This can often result in rather unreadable glyphs. Type1 and Speedo fonts are still scalable with this option since outline based fonts scale much better than bitmaps. Page 4 (printed 10/3/02) XXXXSSSSGGGGIIII((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666)))) XXXXSSSSGGGGIIII((((1111)))) ----oooovvvveeeerrrrllllaaaayyyy specifies that the default visual should be in the overlay planes. Gets optionally combined with ccccllllaaaassssssss and ddddeeeepppptttthhhh. ----ppppsssseeeeuuuuddddoooommmmaaaapppp _s_t_r_i_n_g tells how to initialize default PseudoColor colormaps. _S_t_r_i_n_g must be one of ggggllll, eeeennnnvvvvmmmm, ppppsssseeeeuuuuddddoooo, or 4444ssssiiiigggghhhhtttt. The setting determines the number of cells preallocated by the server for sharing ReadOnly by clients. All preallocated cells contain colors which match those in the default GL "colorindex" colormap. If more cells are preallocated, the default map and maps used by the GL will match better, but fewer cells will be available for allocation by clients. ggggllll preallocates cells 0-15. eeeennnnvvvvmmmm preallocates cells 0-15 and 32-255. ppppsssseeeeuuuuddddoooo preallocates only WhitePixel and BlackPixel. 4444ssssiiiigggghhhhtttt preallocates 0-15 and 32-55. ----ppppttttrrrrddddeeeevvvv _s_t_r_i_n_g sets name of core pointer device ----rrrr turns off keyboard auto-repeat rrrr turns on keyboard auto-repeat ----rrrreeeeppppoooorrrrttttddddeeeeccccoooommmmpppprrrreeeessssssss reports the names of font files being decompressed. ----ssss _m_i_n_u_t_e_s sets screen-saver timeout time in minutes. The screen saver may be disabled by setting the timeout to 0. The default is 10 minutes. Note that using _x_s_e_t(1) sets the timeout in seconds. ----sssseeeeccccuuuurrrriiiittttyyyyEEEExxxxtttt enables the X security extension ----ssssoooolllliiiiddddrrrrooooooootttt _c_o_l_o_r-_n_a_m_e starts the server with a solid color for the initial screen; If not specified, the default is a black and white X stipple background. ----ssssttttaaaacccckkkkeeeedddd arranges screens of a multihead server vertically instead of horizontally. Screen 0 is on the bottom. ----ssssttttaaaattttiiiiccccmmmmaaaapppp _s_t_r_i_n_g tells how to initialize default colormaps. _S_t_r_i_n_g must be one of ggggllll or ccccuuuubbbbeeee. The setting determines Page 5 (printed 10/3/02) XXXXSSSSGGGGIIII((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666)))) XXXXSSSSGGGGIIII((((1111)))) the layout of the maps. ggggllll makes the map look like the GL default map. ccccuuuubbbbeeee fills the map with a color cube. Please do not be confused by the naming, if you want to set the class of the default colormap, use the -_c_l_a_s_s flag. This flag only determines what is stored in the colormap. ----ssssuuuu disables save under support on all screens ----tttt _p_i_x_e_l_s sets the mouse threshold ----ttttoooo _s_e_c_o_n_d_s sets connection timeout in seconds. ttttttttyyyy_x_x starts server on tty_x_x. For use when starting a server from init. vvvv turns on video blanking for screen-saver ----vvvv turns off video blanking for screen-saver ----vvvviiiissssiiiidddd _i_n_t specifies visual ID of default visual. If the number refers to a valid visual, this option overrides ccccllllaaaassssssss, ddddeeeepppptttthhhh and oooovvvveeeerrrrllllaaaayyyy. NNNNOOOOTTTTEEEE:::: the set of visual IDs and the visuals they correspond to is device-dependent. Thus, this set will vary from one board type to the next. Also, for a given board type, there is no guarantee that the set of supported visuals (and their corresponding visual IDs) will not change from one software release to the next. ----wwwwmmmm forces the default backing-store of all windows to be WhenMapped. This is not a very good way of getting backing-store to apply to all windows. ----wwwwrrrraaaappppxxxx allows pointer cursor to wrap around in X direction ----wwwwrrrraaaappppyyyy allows pointer cursor to wrap around in Y direction ----xxxx _e_x_t_e_n_s_i_o_n-_n_a_m_e loads the named extension at init time ++++xxxxiiiinnnneeeerrrraaaammmmaaaa enables Xinerama extension. See _X_i_n_e_r_a_m_a(_3_X_1_1) for details. ----xxxxiiiinnnnddddeeeexxxx _i_n_t sets index of X valuator in pointer device Page 6 (printed 10/3/02) XXXXSSSSGGGGIIII((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666)))) XXXXSSSSGGGGIIII((((1111)))) ----yyyyiiiinnnnddddeeeexxxx _i_n_t sets index of Y valuator in pointer device SSSSEEEECCCCUUUURRRRIIIITTTTYYYY _X_s_g_i uses an access control list for deciding whether or not to accept connections from clients on a particular machine. This list initially consists of the host on which the server is running as well as any machines listed in the file /_e_t_c/_Xnnnn._h_o_s_t_s, where nnnn is the display number of the server. Each line of the file should contain an Internet hostname (_e_g neon.esd.sgi.com). Users can add or remove hosts from this list and enable or disable access control using the _x_h_o_s_t command from the same machine as the server. Please refer to the _x_h_o_s_t(_1) man page for more information. Unlike some window systems, X does not have any notion of window operation permissions; it places few restrictions on what a client can do. If a program can connect to a display, it has full run of the screen and can manipulate most resources it may discover. See also _x_a_u_t_h(_1). SSSSHHHHAAAARRRREEEEDDDD MMMMEEEEMMMMOOOORRRRYYYY TTTTRRRRAAAANNNNSSSSPPPPOOOORRRRTTTT The default transport for local clients uses shared memory for X server communication. Clients may use UNIX domain sockets (the previous default transport) by specifying the display as uuuunnnniiiixxxx::::0000. UNIX domain sockets will automatically be used if shared memory is not available. IIIINNNNPPPPUUUUTTTT DDDDEEEEVVVVIIIICCCCEEEE SSSSUUUUPPPPPPPPOOOORRRRTTTT Clients access core input devices (pointer and keyboard) using core X protocol requests. Additional devices may be accessed using the X Input Extension. See _i_n_p_u_t(_7) for information about configuring input devices. SSSSIIIIGGGGNNNNAAAALLLLSSSS The server attaches special meaning to the following signals: _S_I_G_H_U_P This signal causes _X_s_g_i to close all existing connections, free all resources, and restore all defaults. It is sent by the display manager whenever the main user's primary client exits or after execution of _e_n_d_s_e_s_s_i_o_n to force the server to clean up and prepare for the next user. On many systems, this primary client frequently is an _x_t_e_r_m or a window manager. See _e_n_d_s_e_s_s_i_o_n(_1) and _x_d_m(_1) for details. _S_I_G_T_E_R_M This signal causes _X_s_g_i to exit cleanly. Page 7 (printed 10/3/02) XXXXSSSSGGGGIIII((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666)))) XXXXSSSSGGGGIIII((((1111)))) FFFFIIIILLLLEEEESSSS /_u_s_r/_l_i_b/_X_1_1/_x_d_m/_X_s_e_r_v_e_r_s the default server file used by _x_d_m, supplying options which will be passed to _X_s_g_i. SSSSEEEEEEEE AAAALLLLSSSSOOOO X(1), xdm(1), xauth(1), xhost(1), xdpyinfo(1), input(7), endsession(1), 4Dwm(1), twm(1), xterm(1), xset(1), xsetroot(1), mkfontdir(1), xinit(1), Xinerama(3X11), Xserver(1). BBBBUUUUGGGGSSSS The option syntax is inconsistent with itself and _x_s_e_t(_1). If _X_s_g_i dies before its clients, new clients won't be able to connect until all existing connections have their TCP TIME_WAIT timers expire. Xdmcp doesn't support DES. Bell Volume is not configurable on older SGI architectures. Backing store does not correctly operate on windows which have OpenGL or IRIS GL contexts bound to them. Since GL programs render directly to the graphics hardware, the X server has no ability to correctly retain rendering for obscured regions of such windows. Backing store is not recommended as a performance enhancement to windows containing simple graphics. Backing store is more expensive for deeper windows. Read-modify-write rasterops can be slow on some older SGI architectures. Certain use patterns can cause severe fragmentation of memory in the server. This can lead to large resident core sizes even though core is not leaking. Since the default configuration resets (but does not restart) the server between users, the process may become large without opportunity to shrink. Consequently, performance may suffer as a result of paging, etc. Process size may be examined with _p_s(_1). Should this occur, the server should be terminated and restarted. This can be done via _k_i_l_l(_1) or, if _x_d_m(_1) is used, by changing the tttteeeerrrrmmmmiiiinnnnaaaatttteeeeSSSSeeeerrrrvvvveeeerrrr entry in /_u_s_r/_l_i_b/_X_1_1/_x_d_m/_x_d_m-_c_o_n_f_i_g to TTTTrrrruuuueeee. In IRIX 5.0, a new memory allocation scheme is supported in _X_s_g_i that allows large allocated memory chunks to be returned to the operating system. This should minimize fragmentation problems. Page 8 (printed 10/3/02) XXXXSSSSGGGGIIII((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666)))) XXXXSSSSGGGGIIII((((1111)))) The standard -dpi option for setting the monitor screen resolution is accepted but not used by _X_s_g_i. Most SGI workstations have monitor-detect logic so _X_s_g_i will correctly determine the size and resolution. AAAADDDDDDDDIIIITTTTIIIIOOOONNNNAAAALLLL DDDDOOOOCCCCUUUUMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN Additional documentation for developers of X Window System clients is available on-line and directly from the X consortium. X Consortium 201 Broadway Cambridge MA 02139-1955 Tel: 617-374-1000 Fax: 617-374-1025 membership@x.org http://www.x.org/ CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT Copyright 1989-91 Silicon Graphics Inc. Copyright 1987-91, Massachusetts Institute of Technology. See _X(_1) for a full statement of rights and permissions. Page 9 (printed 10/3/02) 
